home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xt / XtSetSelectionParameters.z / XtSetSelectionParameters
Encoding:
Text File  |  1998-10-30  |  5.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrssss((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXttttSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrssss((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtSetSelectionParameters - specify target parameters for a
  10.           selection request with a single target
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           void XtSetSelectionParameters(_r_e_q_u_e_s_t_o_r, _s_e_l_e_c_t_i_o_n, _t_y_p_e,
  14.           _v_a_l_u_e, _l_e_n_g_t_h, _f_o_r_m_a_t)
  15.                 Widget _r_e_q_u_e_s_t_o_r;
  16.                 Atom _s_e_l_e_c_t_i_o_n;
  17.                 Atom _t_y_p_e;
  18.                 XtPointer _v_a_l_u_e;
  19.                 unsigned long _l_e_n_g_t_h;
  20.                 int _f_o_r_m_a_t;
  21.  
  22.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  23.           _r_e_q_u_e_s_t_o_r Specifies the widget making the request. Must be
  24.                     of clase Core or any subclass thereof.
  25.  
  26.           _s_e_l_e_c_t_i_o_n Specifies the atom that names the selection.
  27.  
  28.           _t_y_p_e      Specifies the type of the property in which the
  29.                     parameters will be passed.
  30.  
  31.           _v_a_l_u_e     Specifies a pointer to the parameters.
  32.  
  33.           _l_e_n_g_t_h    Specifies the number of elements containing data
  34.                     in _v_a_l_u_e, each element of a sized indicated by
  35.                     _f_o_r_m_a_t.
  36.  
  37.           _f_o_r_m_a_t    Specifies the size in bits of the data in the
  38.                     elements of _v_a_l_u_e.
  39.  
  40.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  41.           The specified parameters will be copied and stored in a new
  42.           property of the specified type and format on the requestor's
  43.           window. To initiate a selection request with a target and
  44.           these parameters, a subsequent call to _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e
  45.           or to _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_I_n_c_r_e_m_e_n_t_a_l specifying the same
  46.           requestor widget and selection atomm will generate a
  47.           _C_o_n_v_e_r_t_S_e_l_e_c_t_i_o_n request referring referring to the property
  48.           containing the parameters. If _X_t_S_e_t_S_e_l_e_c_t_i_o_n_P_a_r_a_m_e_t_e_r_s is
  49.           called more than once with the same widget and selection
  50.           without a call to specify a request, the most recently
  51.           specified parameters are used in the subsequent request.
  52.  
  53.           The possible values of _f_o_r_m_a_t may be 8, 16, or 32. If the
  54.           _f_o_r_m_a_t is 8, the elements of _v_a_l_u_e are assumed to be
  55.           sizeof(char); if 16, sizeof(short); if 32, sizeof(long).
  56.  
  57.           To generate a MULTIPLE target request with parameters for
  58.           any of the multiple targets of the selection request,
  59.           precede individual calls to _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e and
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrssss((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXttttSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrssss((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_I_n_c_r_e_m_e_n_t_a_l with corresponding individual
  75.           calls to _X_t_S_e_t_S_e_l_e_c_t_i_o_n_P_a_r_a_m_e_t_e_r_s, and enclose these all
  76.           within _X_t_C_r_e_a_t_e_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t and _X_t_S_e_n_d_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t.
  77.           _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s and _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s_I_n_c_r_e_m_e_n_t_a_l
  78.           cannot be used  to make selection requests with
  79.           parameterized targets.
  80.  
  81.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.           XtGetSelectionParameters(3Xt)
  83.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  84.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.